home *** CD-ROM | disk | FTP | other *** search
/ IRIX 6.2 Development Libraries / SGI IRIX 6.2 Development Libraries.iso / dist / complib.idb / usr / share / catman / p_man / cat3 / complib / ssyevd.z / ssyevd
Text File  |  1996-03-14  |  4KB  |  133 lines
  1.  
  2.  
  3.  
  4. SSSSSSSSYYYYEEEEVVVVDDDD((((3333FFFF))))                                                          SSSSSSSSYYYYEEEEVVVVDDDD((((3333FFFF))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      SSYEVD - compute all eigenvalues and, optionally, eigenvectors of a real
  10.      symmetric matrix A
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      SUBROUTINE SSYEVD( JOBZ, UPLO, N, A, LDA, W, WORK, LWORK, IWORK, LIWORK,
  14.                         INFO )
  15.  
  16.          CHARACTER      JOBZ, UPLO
  17.  
  18.          INTEGER        INFO, LDA, LIWORK, LWORK, N
  19.  
  20.          INTEGER        IWORK( * )
  21.  
  22.          REAL           A( LDA, * ), W( * ), WORK( * )
  23.  
  24. PPPPUUUURRRRPPPPOOOOSSSSEEEE
  25.      SSYEVD computes all eigenvalues and, optionally, eigenvectors of a real
  26.      symmetric matrix A. If eigenvectors are desired, it uses a divide and
  27.      conquer algorithm.
  28.  
  29.      The divide and conquer algorithm makes very mild assumptions about
  30.      floating point arithmetic. It will work on machines with a guard digit in
  31.      add/subtract, or on those binary machines without guard digits which
  32.      subtract like the Cray X-MP, Cray Y-MP, Cray C-90, or Cray-2. It could
  33.      conceivably fail on hexadecimal or decimal machines without guard digits,
  34.      but we know of none.
  35.  
  36.  
  37. AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  38.      JOBZ    (input) CHARACTER*1
  39.              = 'N':  Compute eigenvalues only;
  40.              = 'V':  Compute eigenvalues and eigenvectors.
  41.  
  42.      UPLO    (input) CHARACTER*1
  43.              = 'U':  Upper triangle of A is stored;
  44.              = 'L':  Lower triangle of A is stored.
  45.  
  46.      N       (input) INTEGER
  47.              The order of the matrix A.  N >= 0.
  48.  
  49.      A       (input/output) REAL array, dimension (LDA, N)
  50.              On entry, the symmetric matrix A.  If UPLO = 'U', the leading N-
  51.              by-N upper triangular part of A contains the upper triangular
  52.              part of the matrix A.  If UPLO = 'L', the leading N-by-N lower
  53.              triangular part of A contains the lower triangular part of the
  54.              matrix A.  On exit, if JOBZ = 'V', then if INFO = 0, A contains
  55.              the orthonormal eigenvectors of the matrix A.  If JOBZ = 'N',
  56.              then on exit the lower triangle (if UPLO='L') or the upper
  57.              triangle (if UPLO='U') of A, including the diagonal, is
  58.              destroyed.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. SSSSSSSSYYYYEEEEVVVVDDDD((((3333FFFF))))                                                          SSSSSSSSYYYYEEEEVVVVDDDD((((3333FFFF))))
  71.  
  72.  
  73.  
  74.      LDA     (input) INTEGER
  75.              The leading dimension of the array A.  LDA >= max(1,N).
  76.  
  77.      W       (output) REAL array, dimension (N)
  78.              If INFO = 0, the eigenvalues in ascending order.
  79.  
  80.      WORK    (workspace/output) REAL array,
  81.              dimension (LWORK) On exit, if LWORK > 0, WORK(1) returns the
  82.              optimal LWORK.
  83.  
  84.      LWORK   (input) INTEGER
  85.              The dimension of the array WORK.  If N <= 1,               LWORK
  86.              must be at least 1.  If JOBZ = 'N' and N > 1, LWORK must be at
  87.              least 2*N+1.  If JOBZ = 'V' and N > 1, LWORK must be at least 1 +
  88.              5*N + 2*N*lg N + 3*N**2, where lg( N ) = smallest integer k such
  89.              that 2**k >= N.
  90.  
  91.      IWORK   (workspace/output) INTEGER array, dimension (LIWORK)
  92.              On exit, if LIWORK > 0, IWORK(1) returns the optimal LIWORK.
  93.  
  94.      LIWORK  (input) INTEGER
  95.              The dimension of the array IWORK.  If N <= 1,
  96.              LIWORK must be at least 1.  If JOBZ  = 'N' and N > 1, LIWORK must
  97.              be at least 1.  If JOBZ  = 'V' and N > 1, LIWORK must be at least
  98.              2 + 5*N.
  99.  
  100.      INFO    (output) INTEGER
  101.              = 0:  successful exit
  102.              < 0:  if INFO = -i, the i-th argument had an illegal value
  103.              > 0:  if INFO = i, the algorithm failed to converge; i off-
  104.              diagonal elements of an intermediate tridiagonal form did not
  105.              converge to zero.
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.